import sys
"""使用 sys 模块退出游戏"""

import pygame
"""做游戏靠它"""

from settings import Settings
"""导入设置的类"""
from ship import Ship
from bullet import Bullet
from alien import Alien


class AlienInvasion:
    """管理游戏资源和行为的类"""

    def __init__(self):
        """初始化游戏并创建游戏资源"""
        # 初始化背景，让 pygame 能正确地工作
        pygame.init()
        # 创建一个时钟。当循环速度超过了定义的帧率时， pygame 会计算需要暂停多长时间
        self.clock = pygame.time.Clock()
        # 创建一个 Settings 实例
        self.settings = Settings()
        # 全屏显示
        # self.screen = pygame.display.set_mode((0, 0), pygame.FULLSCREEN)
        # self.settings.screen_width = self.screen.get_rect().width
        # self.settings.screen_height = self.screen.get_rect().height
        # 创建一个显示窗口，（横，纵）
        self.screen = pygame.display.set_mode((self.settings.screen_width, self.settings.screen_height))
        # 设置帧率
        self.fps = self.settings.fps
        """
        赋给属性 self.screen 的对象是一个 surface。
        在 pygame 中， surface 是屏幕的一部分，用于显示游戏元素。
        每个元素（如外星人或飞船）都是一个 surface。
        display.set_mode() 返回的 surface 表示整个游戏窗口，
        激活游戏的循环动画后，每经过一次循环都将自动重绘这个 surface，
        将用户输入除法的所有变化都反映出来。
        """
        # caption 标题，用于设置标题
        pygame.display.set_caption("Alien invasion")
        # 导入 Ship 类，并创建一个 Ship 实例
        self.ship = Ship(self)
        self.bullets = pygame.sprite.Group()
        self.aliens = pygame.sprite.Group()

        self._create_fleet()

    def run_game(self):
        """开始游戏的主循环"""
        while True:
            # 事件循环，侦听键盘和鼠标事件
            self._check_events()
            # 更新飞船位置
            self.ship.update()
            # 子弹
            self._update_bullets()
            # 更新屏幕上的图像，并切换到新屏幕
            self._update_aliens()
            self._update_screen()
            # tick() 方法接受参数：游戏的帧率设置为 60
            self.clock.tick(self.fps)
    
    def _check_events(self):
        """响应案件和鼠标事件"""
        for event in pygame.event.get():
            """
            用 pygame.event.get() 函数访问 pygame 检测到的事件。
            这个函数返回一个列表，其中包含它在上一次调用后发生的所有事件。
            所有键盘和水表事件都将导致这个 for 循环运行。
            """
            # 按 × 退出游戏
            if event.type == pygame.QUIT:
                sys.exit()
            elif event.type == pygame.KEYDOWN:
                self._check_keydown_events(event)
            elif event.type == pygame.KEYUP:
                self._check_keyup_events(event)

    def _check_keydown_events(self, event):
        """响应按下"""
        if event.key == pygame.K_RIGHT:
            self.ship.moving_right = True
        elif event.key == pygame.K_LEFT:
            self.ship.moving_left = True
        # 按 q 退出游戏
        elif event.key == pygame.K_q:
            # 调成英文输入法
            sys.exit()
        elif event.key == pygame.K_SPACE:
            self._fire_bullet()

    def _check_keyup_events(self, event):
        """响应释放"""
        if event.key == pygame.K_RIGHT:
            self.ship.moving_right = False
        elif event.key == pygame.K_LEFT:
            self.ship.moving_left = False

    def _fire_bullet(self):
        """创建一颗子弹，并将其加入编组 bullets"""
        if len(self.bullets) < self.settings.bullets_allowed:
            new_bullet = Bullet(self)
            self.bullets.add(new_bullet)

    def _update_bullets(self):
        """更新子弹的位置并删除已消失的子弹"""
        # 更新子弹的位置
        self.bullets.update()
        for bullet in self.bullets.copy():
            if bullet.rect.bottom <= 0:
                self.bullets.remove(bullet)

        # 检查是否有子弹击中了外星人
        # 如果时，就删除相应的子弹和外星人
        collisions = pygame.sprite.groupcollide(self.bullets, self.aliens, True, True)
        """
        每当 rect 重叠时， gorupcollide() 就在返回的字典中添加一个键值对
        两个 True 告诉 pygame 在碰撞时删除对应的子弹和外星人
        """

    def _create_fleet(self):
        """创建一个外星舰队"""
        # 创建一个外星人,再不断添加，知道没有空间添加外星人为止
        # 外星人的间距为外星人的宽度和高度
        alien = Alien(self)
        # 属性 size 是一个元组，包含外星人的宽度和高度
        alien_width, alien_height = alien.rect.size

        current_x, current_y = alien_width, alien_height
        while current_y < (self.settings.screen_height - 3 * alien_height):
            while current_x < (self.settings.screen_width - 2 * alien_width):
                self._create_alien(current_x, current_y)
                current_x += 2 * alien_width

            # 添加一行外星人后，充值 x 值并递增 y 值
            current_x = alien_width
            current_y += 2 * alien_height
    
    def _check_fleet_edges(self):
        """在有外星人到达边缘时采取相应的措施"""
        for alien in self.aliens.sprites():
            if alien.check_edges():
                self._change_fleet_direction()
                break

    def _change_fleet_direction(self):
        """将整个外形舰队向下移动，并改变他们的方向"""
        for alien in self.aliens.sprites():
            alien.rect.y += self.settings.fleet_drop_speed
        self.settings.fleet_direction *= -1

    def _create_alien(self, x_position, y_position):
        """创建一个外星人并将其放在当前行中"""
        new_alien = Alien(self)
        new_alien.x = x_position
        new_alien.rect.x = x_position
        new_alien.rect.y = y_position
        self.aliens.add(new_alien)

    def _update_aliens(self):
        """检查是否有外星人位于屏幕边缘，更新外形舰队中所有外星人的位置"""
        self._check_fleet_edges()
        self.aliens.update()

    def _update_screen(self):
        """更新屏幕上的图像，并切换到新屏幕"""
        self.screen.fill(self.settings.bg_color)
        """
        fill() 方法用颜色填充屏幕。
        fill() 方法用于处理 surface，只接受一个表示颜色的实参。
        """
        for bullet in self.bullets.sprites():
            bullet.draw_bullet()
        # 调用 ship.blitme() 将飞船绘制到屏幕上
        self.ship.blitme()
        self.aliens.draw(self.screen)

        # 让最近绘制的屏幕可见，擦去旧屏幕
        pygame.display.flip()

# 这个结构可以让文件在被调用时，其中的代码不被执行
if __name__ == '__main__':
    # 创建游戏实例并运行游戏
    ai = AlienInvasion()
    ai.run_game()